Emulex LPFC Application Helper Module Installation Notes
----------------------------------------------------------------------

1. System Requirements
2. Installation Process
3. Release Notes
   3.1  Red Hat Enterprise Linux 'kernel-devel' Package Requirement
   3.2  SuSE Linux Enterprise Server 'kernel-source' Package Requirement
   3.3  Support for HBAnyware 2.3
   3.4  Cleanup Obsolete Code
   3.5  Fix GetFcpTargetMapping
        3.5.1 Background
        3.5.2 Observed Problem
        3.5.3 Resolution

----------------------------------------------------------------------

1. System Requirements

   The following distributions of Linux are supported by the Emulex
   LPFC Application Helper Module:

	Red Hat Enterprise Linux 4 (Update 2 or higher)
	SuSE Linux Enterprise Server 9 (SP1 or higher)

   This Emulex LPFC Application Helper Module will function with the
   Emulex LPFC driver that ships with these distributions of Linux as
   well as the Emulex LPFC driver that is installed as part of the
   Emulex LPFC 8.0.16.27 driver kit.

2. Installation Process

   The ioctl-install script can be used to install and uninstall the
   LPFC Application Helper Module RPM.  This RPM installs the module
   sources to the /usr/src/lpfcdfc directory, builds the module for
   the currently running kernel, and then installs the module to the
   proper directory for the currently running kernel.

   Once the RPM is installed, the 'elxlpfc' init script is installed
   and configured to start and stop the 'lpfcdfc' driver during system
   startup and shutdown.

   For usage information, please execute the command:

      ./ioctl-install --help

3. Release Notes

3.1  Red Hat Enterprise Linux 'kernel-devel' Package Requirement

   For Red Hat Enterprise Linux installations, the kernel development
   package with the same version as the currently running kernel must
   be installed for the LPFC 8.0 driver build to succeed.  For
   example, a system with the 2.6.9-22.EL kernel would need the
   kernel-devel-2.6.9-22.EL package, and a system with the
   2.6.9-22.ELsmp kernel would need the kernel-smp-devel-2.6.9-22.EL
   package.

3.2  SuSE Linux Enterprise Server 'kernel-source' Package Requirement

   For SuSE Linux Enterprise Server installations, the kernel-source
   package with the same version as the currently running kernel must
   be installed for the LPFC 8.0 driver build to succeed.  For
   example, a system with the 2.6.5-7.139-bigsmp kernel would need the
   kernel-source-2.6.5-7.139 package.

3.3 Support for HBAnyware 2.3

   HBAnyware 2.3 adds many new diagnostic features that require support
   by the Application Helper Module and libdfc. Changes were made to
   support the following:

      ResetAdapter
      Beaconing
      Diagnostic Dump
      Loopback Tests
      POST test
      Echo test

3.4 Cleanup Obsolete Code

   There were significant portions of code surrounded by ifdefs that
   are no longer used in the 8.0 driver. This code was removed.

3.5 Fix GetFcpTargetMapping

3.5.1 Background

   GetFcpTargetMapping was not implemented in the initial release of
   the 8.0 driver.

3.5.2 Observed Problem

   Attempting to list target mappings through HBAnyware, hbccmd, or
   lputil would result in an error message.

3.5.3 Resolution

   GetFcpTargetMapping is now implemented entirely within libdfc via
   sysfs.

----------------------------------------------------------------------
Document Revision:  $Revision: 2906 $
